home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / compress / unlzh172.lzh / UNLZH.DOC < prev    next >
Text File  |  1990-08-04  |  16KB  |  330 lines
  1.  
  2. UNLZH version 1.7 - A program for extracting .LZH archive files.
  3.  
  4. UNLZH combines an easy to use, GEM based interface with high speed
  5. extraction routines, to give you a much simpler and much faster way to
  6. extract LZH archives.  It is a self contained program - you do not need
  7. to have LHARC or any 'shell'.  It is written in 100% Assembly language,
  8. and extracts approximately four times faster than LHARC.
  9.  
  10. UNLZH can search past damaged sections of an archive, and should be able
  11. to extract the rest of the files.
  12.  
  13. UNLZH can also extract multiple archives at once, and place the contents
  14. in individual folders.
  15.  
  16. How to Use the Program:
  17. -----------------------
  18.  
  19. UNLZH will start with a menu screen that contains configuration options,
  20. and all the main functions.  In the upper part of the menu are two program
  21. options that should be set up before selecting any of the function buttons
  22. in the lower part.
  23.  
  24. The first option, Create Folders, can be used if you want the program to
  25. create a folder with the same name as the archive file, and place all the
  26. extracted contents within it.  If you want to extract directly to the
  27. destination path, select 'No' for the Create Folders option.
  28.  
  29. When the second option, Overwrite Files, is set to 'No', the program will
  30. prompt you if one of the files to be extracted already exists.  (Similar
  31. to the warning the GEM desktop gives you when you try to copy a file that
  32. already exists).  Selecting 'Yes' for this option will bypass the warning
  33. prompt, and overwrite any files that may have already existed.
  34.  
  35. Program Functions:
  36. ------------------
  37.  
  38. - Extract -
  39.  
  40. The first, and default function is to Extract all.  This will prompt you
  41. for an input archive file, then a destination path, and then extract all
  42. the files from the archive.  If the Create Folders option is turned on,
  43. a folder will be created at the destination path, and the files will be
  44. extracted into it.  If a folder by that name already exists, the program
  45. will extract into the already existing folder.
  46.  
  47. To extract multiple archives at once, just enter an '*' for the input
  48. filename.  UNLZH will then extract all of the archives in that directory.
  49. You should have the Create Folders option turned on, so that the archives
  50. will extract into separate folders.
  51.  
  52. - W/Query -
  53.  
  54. Extract With Query operates the same as the full Extract, except that
  55. after selecting the input archive file, another menu will come up which
  56. displays all of the files contained in the archive.  You may click on
  57. individual files to select them, or hold the left mouse button down and
  58. drag the pointer over a group of files.  Files selected for extraction are
  59. indicated by having an '*' placed in front of the file name.  Files may
  60. also be deselected in the same way.  When you have selected all the
  61. desired files, click on the Extract button.  The ALL button is a short
  62. cut, in case you decide you want all the files after all, and don't want
  63. to select them all manually.  You can also click on Quit, which will
  64. return you to the initial menu.
  65.  
  66.  
  67. If the archive file has been damaged, some of the selections may display as
  68. '- Bad Header -'.  These sections cannot be extracted, however UNLZH will
  69. search the rest of the archive to find as many good files as possible.
  70.  
  71. - To Screen -
  72.  
  73. Extract to Screen also displays a menu of the archive contents.  Some files
  74. may already be selected for extraction.  Any file beginning with READ, or
  75. having the extension .TXT, .DOC, or .ASC, will be marked.  Also, if there
  76. is only one file in the archive, it will be marked to extract.  If you wish
  77. to extract the pre-selected files, you can immediately select the Screen or
  78. Printer option at the bottom of the menu.  Otherwise, you may manually
  79. select which file(s) you want to look at in the same manner as described for
  80. Extract with Query.
  81.  
  82. A maximum of 3 files will be marked, except in cases where the archive
  83. contains all text files, in which case none of the files will be pre-marked.
  84.  
  85. Screen listings will pause every 24 lines.  (Or more if you are using a
  86. larger screen).  There are many options to control the screen listing:
  87.  
  88. Left Mouse Button - Continue listing one line at a time
  89. Right Mouse Button - Reverse scroll the listing, one line at a time
  90. Both Buttons - Abort listing
  91.  
  92. 'Return' - Display one line at a time
  93. 'Down Arrow' or 'Space Bar' - Display one screen at a time
  94. 'Up Arrow' - Back up to the previous screen
  95. 'Shift' & 'Down Arrow' - Jump 4 screens forward
  96. 'Shift' & 'Up Arrow' - Jump 4 screens backward
  97. 'Home' - Return to the top of the file
  98. 'S' - Enter Search and Move menu:
  99.  
  100.       To perform a search, enter a phrase to search for, and select whether
  101.       the program should 'Match', or 'Ignore' differences in upper/lower
  102.       case.  Then click on either 'Search' or 'Next' to begin searching.
  103.       (You may also press the 'Return' key for the Next function).
  104.       'Search' will start at the top of the file, and 'Next' will start at
  105.       the current location.  The program will display the next line that
  106.       contains the search phrase.  If no match was found, the display will
  107.       be in the same place, and the Bell will sound.
  108.  
  109.       The other buttons allow you to jump directly to one of five positions.
  110.       'Top' jumps to the top of the file.  (Same as Home)
  111.       '1/4' jumps to a position one quarter of the way through the file
  112.       '1/2' jumps to half way through the file
  113.       '3/4' jumps three quarters of the way through
  114.       'End' jumps to the end of the file
  115.  
  116. 'N' - Display the 'Next' match, using the current search phrase
  117. 'P' - Send a block of text to the Printer:
  118.  
  119.       The first 'P' will mark the top line of the current screen as the top
  120.       of the block.  Then move down to the end of the area you wish to print,
  121.       and press 'P' again.  This will send all of the text from your first
  122.       mark, to the bottom line of the ending screen, to the printer.
  123.  
  124. 'D' - Send a block of text to a disk file.  This works the same as the 'P'
  125.       function, except you will get a GEM file selector to enter a name for
  126.       the text file to write the block to.
  127.  
  128. Press 'ESC' to abort either screen or printer listings.
  129.  
  130. If multiple files were selected for extraction, Abort will progress to the
  131. next file.  This, combined with the search capabitities, allows you to
  132. search multiple files very easily.
  133.  
  134. Notes: In low memory situations, where there is not enough room to store
  135. the entire extracted file, the process is done in segments, and there are a
  136. few differences in the way the program responds.
  137.  
  138. Backing up the display is limited to how much of the extracted file is still
  139. in memory.  You may find a point where you can't back up any further.  This
  140. is because the data before this point has been overwritten.  This
  141. restriction does not occur with the Home, Search, and Jump functions, and
  142. they may be used to get back to earlier sections of the file.
  143.  
  144. After a search where a match is not found, the program will try to return
  145. to the previous location.  If that spot is no longer in memory, the program
  146. will jump to the top of the file.
  147.  
  148. When using the Print Block feature, you may be scrolling the file across one
  149. of the segment boundaries.  If this happens the program will immediately
  150. send all the data so far, out to the printer.  The scrolling process will be
  151. paused until the data has been sent.  Afterwards, you can continue scrolling
  152. to the desired end position, and press 'P' to print the rest of the data.
  153.  
  154. Again, unless you operate the program in low memory situations, and/or
  155. extract large text files, you will not see any of these behaviors.
  156.  
  157. - Test -
  158.  
  159. The Test function is used to test the files in an archive without actually
  160. extracting any of them.  It will display 'Okay' after each valid file, and
  161. report any problems found in the archive.  It operates like Extract with
  162. Query, but does not ask you for a destination path, (as it does not write
  163. out any extracted files).
  164.  
  165. - View -
  166.  
  167. View allows you to look at all the files in an archive.  It will ask for
  168. an input archive file, and then displ